home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 025a / cdbase11.zip / CDBASE.DOC < prev    next >
Text File  |  1991-12-10  |  20KB  |  463 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.        ▄████████▄     █████████▄       ║
  11.      ▄███▀    ▀███▄   ██     ▀███▄     ║             RELEASE 1.1
  12.     ▄██▀        ▀██▄  ██       ▀███▄   ║     Copyright (C) 1991  Greg Clow
  13.     ███          ███  ██         ▀██   ║
  14.     ███               ██          ██   ║
  15.     ███               ██          ██   ║
  16.     ███          ███  ██         ▄██   ╠══════╗  ══════╗ ╔══════╗ ╔══════╗
  17.     ▀██▄        ▄██▀  ██       ▄███▀   ║      ║        ║ ║        ║      ║
  18.      ▀███▄    ▄███▀   ██     ▄███▀     ║      ║ ╔══════╣ ╚══════╗ ╠══════╝
  19.        ▀████████▀     █████████▀       ║      ║ ║      ║        ║ ║
  20.          ▀▀▀▀▀▀       ▀▀▀▀▀▀▀          ╚══════╝ ╚══════╝ ╚══════╝ ╚══════════
  21.            A Compact Disc, Record and Cassette cataloguing application
  22.  
  23.  
  24.      This SHAREWARE program may be freely copied and distributed on a
  25.      non-commercial basis.  If you wish to use it regularly and did not
  26.      purchase this software from a liscensed distributor (as listed
  27.      below), please register as a user.  For details, please see the
  28.      last two pages of this document.
  29.  
  30.      The only retail outlet currently liscensed to sell this software
  31.      is Hypermedia in Toronto, Ontario.  A portion of the retail price
  32.      paid for this program at Hypermedia will be given to the programmer
  33.      as the registration fee.  As well, copies of this software sold at
  34.      Hypermedia are accompanied by a special registration form indicating
  35.      the registration fee for that copy of CDbase has been paid.
  36.  
  37.      If you PURCHASED this software from anywhere besides Hypermedia,
  38.      you have NOT paid the registration fee, and must do so in order to
  39.      become a registered user.
  40.  
  41.  
  42. DISCLAIMER, COPYRIGHTS, ETC.
  43.  
  44. I, Greg Clow, hereby disclaim all warranties relating to this software
  45. (CDbase), whether expressed or implied, including, and without limitation to,
  46. any implied warranties or merchantability or fitness for a particular
  47. purpose.  I will not be liable for any special, incidental, consequential,
  48. indirect, or similar damages due to the use or misuse of this software or for
  49. any reason, even if I or an agent of mine have been advised of the
  50. possibility of such damages.  In no event shall my liability for any damages
  51. ever exceed the price I am charging for these files, regardless of the form
  52. of the claim.  The person using the software bears all risk as to the quality
  53. and performance of the software.
  54.  
  55. The program known as CDBASE.EXE and all associated files are provided to you
  56. without warranty of any kind.  USE IT AT YOUR OWN RISK.  The files may be
  57. distributed to anyone provided my copyright notice is not removed from within
  58. the executable.  You may NOT distribute or sell this program as your own
  59. creation.
  60.  
  61.  
  62. Clipper (R) is a registered trademark of the Nantucket Corporation.
  63.  
  64. dBASE III+ (R) is a registered trademark of Ashton-Tate Corporation.
  65.  
  66.  
  67. BACKGROUND
  68.  
  69. I've been a music fan for a long time (well, not that long, but long for a 22
  70. year old!).  When I got my first computer back in my mid-teens, I decided to
  71. develop a little dBASE III+ application to catalogue my record and cassette
  72. collection.  I wasn't a great programmer, and it wasn't a great program, but
  73. it did the job.
  74.  
  75. Then, a couple of years ago, I entered the digital age and bought a CD
  76. player.  Owning this new technology inspired me to improve my application as
  77. well, so I used my new-found knowledge of Clipper (Summer '87) and developed
  78. a new application.  Once again, it wasn't great, but it did the job.
  79.  
  80. Well, along came Clipper 5.0, and I started thinking "Now would be a good
  81. time to improve my application again".  I kept putting it off, however, until
  82. recently, when a new store called Hypermedia opened here in Toronto.
  83. HyperMedia sells alternative music, video, literature, and COMPUTER SOFTWARE! 
  84. Seeing this finally inspired me to re-develop my little system into what you
  85. now have: CDbase.
  86.  
  87.  
  88.  
  89. WHAT IS CDbase?
  90.  
  91. As I said, CDbase is an application written in Clipper 5.01 that is used to
  92. catalogue your compact disc, record and tape collection.  It also prints a
  93. couple of simple listing reports which you can use to impress your friends
  94. and amaze your neighbours ("Wow, Jerry, I never knew you owned so many Wayne
  95. Newton CDs!  Can I get a copy of this list?").
  96.  
  97. One thing that CDbase is NOT is perfect.  It doesn't have any major bugs
  98. (hopefully!), but it might not have everything you want as far as data that
  99. can be entered, reports that can be generated, etc.  SEND ME COMMENTS!  If
  100. you have a problem with the program, an idea you think is good, or anything,
  101. let me know.  My address is on the last page.
  102.  
  103.  
  104.  
  105. CHANGES FROM RELEASE 1.0 TO 1.1
  106.  
  107. Just a couple of minor bug fixes:
  108.   Fixed the headers/footers on the report, which sometimes didn't appear.
  109.   Fixed logic in data entry & edit which sometimes caused the table to go
  110.    past the end of file, or sometimes appended a blank record.
  111.  
  112.  
  113. WHAT YOU SHOULD HAVE
  114.  
  115. The CDbase disk (or .ZIP file, or .ARC file, or whatever) should contain the
  116. following files:
  117.  
  118. CDBASE.DOC     -    you're reading it!
  119. CDBASE.EXE     -    the program (duh!)
  120. CDBASE.DBF     -    the database file
  121. CDBASE.NTX     -    index file (used for database searches, etc.)
  122. LOWERCAS.DBF   -    the lower case table (discussed later)
  123. LOWERCAS.NTX   -    index file
  124.  
  125. If you're missing one or more of these files, you got ripped off!  Go yell at
  126. whoever gave you this stuff, and if that doesn't work, write to me for the
  127. latest version of CDbase (see last two pages).
  128.  
  129.  
  130. INSTALLING AND RUNNING CDbase
  131.  
  132. Installing this thing is easy:
  133.  
  134. 1)   Create a subdirectory on your hard drive (the name is unimportant, but
  135.      I'd recommend something recognizable, like maybe... I don't know...
  136.      "/CDBASE" or something...).
  137.  
  138. 2)   Copy all the CDbase files into the new directory.
  139.  
  140. 3)   Go into the new directory.
  141.  
  142. 4)   Type CDBASE to run the program.
  143.  
  144. And there you are.  The CDbase logo screen should appear before you.  Hit
  145. ENTER.  The MAIN MENU screen appears, and off you go...
  146.  
  147.  
  148.  
  149. ************* IMPORTANT!!! *************
  150.  
  151. UPDATING FROM RELEASE 1.0 TO RELEASE 1.1
  152.  
  153. If you have already been using Release 1.0 of CDbase, copy ONLY the new
  154. CDBASE.EXE (and CDBASE.DOC, if you choose) into your CDbase directory.  DO
  155. NOT overwrite the .DBF and .NTX files with the Release 1.1 versions, or you
  156. will lose your data!
  157.  
  158.  
  159. MAIN MENU
  160.  
  161. The CDbase Main Menu (and all other menus) are of the popular "light bar"
  162. variety.  One of the options on the menu is highlighted, and using the Up and
  163. Down cursor keys moves the highlight up or down.  Hitting ENTER will activate
  164. the currently highlighted option (this can also be done by pressing the first
  165. letter of one of the options).
  166.  
  167. The Main Menu has three options, each of which will be discussed in detail in
  168. the following pages:
  169.  
  170.          Enter and Maintain Data
  171.          Produce Report
  172.          Utilities
  173.  
  174. Pressing the ESCape key from this screen will cause you to exit CDbase.
  175.  
  176.  
  177. ENTER AND MAINTAIN DATA
  178.  
  179. As the name suggests, this option allows you to enter, change, or delete data
  180. in the CDbase database of compact discs, records, and cassettes.
  181.  
  182. The first time you select this option, you will be faced with a (almost)
  183. blank screen.  Once you have entered data, each CD, record and tape entered
  184. will appear as one line on this screen.
  185.  
  186. Across the top will be names of the various fields you will be entering into
  187. the database (ARTIST, TITLE, etc.).  Across the bottom are the various keys
  188. that are active on this screen.  Each of these keys and what they do are
  189. described below:
  190.  
  191.  
  192. ESC key:
  193.      Cancels ENTER AND MAINTAIN DATA and returns to the Main Menu.
  194.  
  195. Cursor Keys:
  196.      Moves the highlight "bar" from field to field and line to line.
  197.  
  198. PgUp and PgDn:
  199.      Scrolls to the next screen up or down of data.
  200.  
  201. S key:
  202.      Starts the search function, which allows you to search for a particular
  203.      ARTIST in the database.  You are prompted to enter the name of the
  204.      artist you wish to find.  If the artist is found, the screen will go to
  205.      that area of the database. 
  206.  
  207. ENTER key:
  208.      Allows you to edit the line that the highlight bar is currently on.  The
  209.      record will come up in the Data Entry/Edit Screen (which is described in
  210.      the INSert key section below).
  211.  
  212. INSert key:
  213.      Allows you to add a new CD, record or tape to the database.  The Data
  214.      Entry/Edit Screen will appear.  On this screen are the following fields:
  215.  
  216.      ARTIST -       The person or group who recorded the recording (that
  217.                     sentence was brought to you by the Department of
  218.                     Redundancy Department!).
  219.  
  220.                     (Just a note... I prefer to enter the names of single
  221.                     artists [i.e. DAVID BOWIE] in a "last-name-first" fashion
  222.                     [i.e. BOWIE, DAVID].  The program, however, will accept
  223.                     either format.)
  224.  
  225.                     The ARTIST field is in upper case, and when reports are
  226.                     generated, this is the field used to sort the data. 
  227.                     However, you may prefer to have certain "artists" to
  228.                     appear out of order.  For example, I prefer to have
  229.                     recordings by "VARIOUS ARTISTS" and "SOUNDTRACKS" to
  230.                     appear at the end of my reports.  Since the standard
  231.                     ASCII sort sequence is upper case and then lower, I have
  232.                     set up a table into which you may enter data which, when
  233.                     found in the ARTIST field, should be stored internally as
  234.                     lower case.  This table is available from the UTILITIES
  235.                     option on the Main Menu.
  236.  
  237.  
  238. ENTER AND MAINTAIN DATA (cont.)
  239.  
  240.                     It should also be noted that having this field renders
  241.                     CDbase almost useless for cataloguing classical music
  242.                     releases, since they tend to have both a composer and a
  243.                     conductor/orchestra.  Personally, for the few classical
  244.                     releases that I do own, I tend to put the composer if the
  245.                     release features only one, and the conductor/orchestra if
  246.                     the release is a "compilation" of music by different
  247.                     composers.
  248.  
  249.      TITLE -        The title of the recording.
  250.  
  251.      TYPE -         This field contains the type of recording as indicated on
  252.                     the following list:
  253.                     7"  :     7 inch single
  254.                     10" :     10 inch single
  255.                     12" :     12 inch single
  256.                     EP  :     Extended play or "mini-album"
  257.                     LP  :     Full length album
  258.                     --  :     Not applicable (i.e. "bootleg" recording,
  259.                               recording from radio, etc.)
  260.  
  261.      FORMAT -       This field contains the format of the recording as
  262.                     indicated on the following list:
  263.                     D   :     Compact Disc
  264.                     V   :     Vinyl
  265.                     C   :     Pre-recorded cassette
  266.                     H   :     "Homemade" cassette (this is not meant to
  267.                               endorse home taping, but let's face it - it
  268.                               happens!)
  269.  
  270.      UNITS -        Number of CDs, records or cassettes contained.  This
  271.                     defaults to "1", but would be changed to "2" for a double
  272.                     album, "3" for a triple album, etc.
  273.  
  274.      SEQUENCE # -   The Sequence Number is used to sort releases within the
  275.                     Artist and Type for reports, etc. (i.e. when you generate
  276.                     a report, the recordings will be sorted by Artist, Type,
  277.                     and Sequence Number in that order.)  This is useful if
  278.                     you wish to have recordings listed in the order of
  279.                     release.  
  280.  
  281.                     The Sequence Number is automatically generated when you
  282.                     enter the Type, but can be changed.  For example, if you
  283.                     own 3 Kate Bush LPs, and add a fourth to the database, it
  284.                     will be given Sequence Number "4".  However, if you
  285.                     realize that the new addition is actually the second Kate
  286.                     Bush LP, you can change the Sequence Number to "2".  It
  287.                     will be inserted in the proper place and all following
  288.                     Sequence Numbers on Kate Bush LPs will be incremented
  289.                     accordingly.
  290.  
  291.      LABEL 1-3 -    These three fields are used to enter the record label(s)
  292.                     of the recording.  There is space for three labels to
  293.                     allow for subsidiaries of larger companies, distributors,
  294.                     etc. to be entered.  For example, Nettwerk is distributed
  295.                     by Capitol here in Canada.  Vertigo is a subsidiary of
  296.                     PolyGram. (NOTE: These fields are optional.)
  297.  
  298.  
  299. ENTER AND MAINTAIN DATA (cont.)
  300.  
  301.      CATALOG # -    This field is pretty self-explanatory: it is used to
  302.                     store the Catalog or Serial Number that is usually found
  303.                     on the spine or back cover of the recording.  This field
  304.                     is optional... I don't enter it myself, but I'm sure
  305.                     someone will find it useful!
  306.  
  307.      NOTES -        Space for miscellaneous notes such as "Has a gatefold
  308.                     sleeve", "Limited edition release", "#@$!in' excellent
  309.                     album, man!" or whatever you like
  310.  
  311.      While entering or editing as entry, several keys are active: the right/
  312.      left cursor keys move within a field, the up/down cursor keys move from
  313.      field to field, the ENTER keys moves to the next field, F4 saves the
  314.      entry, and ESC cancels all changes and returns to the list screen.
  315.  
  316. DELete key:
  317.      Deletes the currently highlighted line (don't worry, it warns you and
  318.      gives you a chance to cancel in case you hit the key accidentally!).
  319.  
  320.  
  321. PRODUCE REPORT
  322.  
  323. Currently, there is only one report available from CDbase.  This report lists
  324. all recordings in the database, and has a format as shown below:
  325.  
  326. 29 NOV 1991                  YOUR REPORT TITLE HERE!                  PAGE: 1
  327. (LEGEND:  D - compact disc  V - vinyl  C - cassette  H - "homemade" cassette)
  328. -----------------------------------------------------------------------------
  329.  
  330.      ALIEN SEX FIEND
  331.                Who's Been Sleeping In My Brain?         LP   H
  332.                Acid Bath                                LP   V
  333.  
  334.      BAUHAUS
  335.                She's In Parties                          7"  V
  336.                Bela Lugosi's Dead                       12"  V
  337.                In The Flat Field                        LP   D
  338.                Mask                                     LP   D
  339.                1979-1983                              2xLP   V
  340.                ...
  341.  
  342. Well, you get the idea.  As mentioned before, the report is sorted by Artist,
  343. Type, and Sequence Number.
  344.  
  345. When you select Produce Report from the Main Menu, you are asked to enter a
  346. title for the report, and also whether or not you want the "LEGEND:" line to
  347. appear on the report.  Once you've done this, the report is sent to the ASCII
  348. text file "CDBASE.RPT", which you can then browse, edit or print.
  349.  
  350. Any ideas for reports you'd like to see added to future releases of CDbase
  351. are welcomed and encouraged.
  352.  
  353.  
  354. UTILITIES
  355.  
  356. The Utilities menu has two options:
  357.  
  358. (1) MAINTAIN LOWER CASE TABLE
  359.      This is the table I mentioned earlier that specifies which Artist values
  360.      you wish to be stored in lower-case format so they appear at the end of
  361.      the report.  As with the main CDbase database, you add to this table with
  362.      the INS key and delete with the DEL key.
  363.  
  364. (2) RE-INDEX FILE:
  365.      Corrupted index files can occur in Clipper applications.  If your database
  366.      seems to be acting strangely (i.e. Led Zeppelin is appearing before AC/DC
  367.      on your report), try running this utility.  95% of the time, this will
  368.      take care of the problem.  The other 5%... let me knoe so I can try to
  369.      find the problem and fix it.
  370.  
  371.  
  372. THIS IS SHAREWARE!
  373.  
  374. By now, I'm sure you're familiar with the ShareWare concept: masochistic
  375. programmers like myself slave away for hours (DAYS, even!) over a hot
  376. keyboard and end up with relatively useful applications and utilities that
  377. they figure might be useful to someone besides themselves.  So they spread
  378. them around and say "Hey!  I wrote this nifty program.  Here's a copy...
  379. if you like it, please send me money!"  And, of course, people get these
  380. programs and try them out, and some of them take pity upon the poor,
  381. unappriciated programmer and send him or her a few measly dollars for thier
  382. troubles.
  383.  
  384. So here's what I want you to do.  Try CDbase.  If you like it, send me
  385. money.  Any amount.  $100 would be nice.  $1000 would be nicer.  But, I must
  386. be realistic... so I'm offering this fine, fine program for the bargain
  387. basement price of $10 (but larger amounts will be gladly accepted.).  Send
  388. cheque, money order, cash, or other valuables to the address on the
  389. registration form on the following page.  And while you're at it, fill out
  390. the form and send it too!
  391.  
  392. When you register, you will receive the latest version of CDbase.  As for
  393. later releases: I don't anticipate that I will be charging a fee for upgrades
  394. in the near future, but that may change depending upon the response to this
  395. product (i.e. postage ain't cheap, folks!).  For now, I'll say that the 1.x
  396. releases should be free.  Once I get into 2.x, etc., upgrade fees may appear.
  397.  
  398. So, please register.  And let me know what you think of CDbase.
  399.  
  400.  
  401. Greg Clow
  402. December, 1991
  403.  
  404.  
  405.  
  406.       ▄████████▄     █████████▄       ║
  407.     ▄███▀    ▀███▄   ██     ▀███▄     ║
  408.    ▄██▀        ▀██▄  ██       ▀███▄   ║     Copyright (C) 1991  Greg Clow
  409.    ███          ███  ██         ▀██   ║          192 Jarvis St. #702
  410.    ███               ██          ██   ║       Toronto Ontario   M5B 2J9
  411.    ███               ██          ██   ║
  412.    ███          ███  ██         ▄██   ╠══════╗  ══════╗ ╔══════╗ ╔══════╗
  413.    ▀██▄        ▄██▀  ██       ▄███▀   ║      ║        ║ ║        ║      ║
  414.     ▀███▄    ▄███▀   ██     ▄███▀     ║      ║ ╔══════╣ ╚══════╗ ╠══════╝
  415.       ▀████████▀     █████████▀       ║      ║ ║      ║        ║ ║
  416.         ▀▀▀▀▀▀       ▀▀▀▀▀▀▀          ╚══════╝ ╚══════╝ ╚══════╝ ╚══════════
  417.         A Compact Disc, Record and Cassette cataloguing application
  418.  
  419.  
  420.  
  421. Thank you for registering your copy of CDbase!  As a registered user, you will
  422. receive the usual benefits offered to ShareWare users, such as updates and
  423. information regarding the future of this product.  Also, your comments and
  424. criticisms of CDbase are always welcome.  Thanks again!
  425.  
  426.  
  427. NAME:     __________________________________________________________________
  428.  
  429. ADDRESS:  __________________________________________________________________
  430.  
  431.           __________________________________________________________________
  432.  
  433.           __________________________________________________________________
  434.  
  435. PHONE #:  (____) ____-_______  (optional)
  436.  
  437.  
  438. Where did you get CDbase?:  ________________________________________________
  439.  
  440.  
  441. What release of CDbase do you have?:  ______
  442.  
  443. What diskette format do you prefer for updates?:   3 1/2 _____   5 1/4 _____
  444.  
  445. COMMENTS/CRITICISMS:
  446.  
  447. ____________________________________________________________________________
  448.  
  449. ____________________________________________________________________________
  450.  
  451. ____________________________________________________________________________
  452.  
  453. ____________________________________________________________________________
  454.  
  455. ____________________________________________________________________________
  456.  
  457. ____________________________________________________________________________
  458.  
  459. ____________________________________________________________________________
  460.  
  461. ____________________________________________________________________________
  462.  
  463.